home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / remote / timechek.zip / TIMECHEK.DOC < prev    next >
Text File  |  1992-02-01  |  5KB  |  133 lines
  1.  
  2.  
  3.    ┌────── WARNING ──────────────── WARNING ─────────────── WARNING ──────┐
  4.    │                                                                      │
  5.    │    THIS IS A BETA VERSION!  This BETA version of TIMECHEK has been   │
  6.    │    released to the general public under the following conditions:    │
  7.    W                                                                      W
  8.    A      1: You accept FULL responsibility for any and all damage        A
  9.    R         this software may cause to your system because of bugs       R
  10.    N         or any other unforseen problems.                             N
  11.    I                                                                      I
  12.    N      2: You should not expect bug fixes or updates with any          N
  13.    G         regularity nor should you expect elaborate docs or           G
  14.    │         packaging.                                                   │
  15.    │                                                                      │
  16.    │                                                                      │
  17.    │                                                                      │
  18.    └────── WARNING ──────────────── WARNING ─────────────── WARNING ──────┘
  19.  
  20.  
  21. TIMECHEK; a RACE subscription utility program, v0.1
  22.  
  23. info
  24. ----
  25.  
  26. If you couldn't tell by running it, I'd be surprised, but just in case..
  27. TIMECHEK is a variation of SUBDATE.EXE.  Added a few things here and there,
  28. took away a few others, etc., and VOILA... TIMECHEK!
  29.  
  30. Because TIMECHEK is so similar in operation to SUBDATE, I will refer you to
  31. the SUBDATE.DOC file for many of the command line option descriptions. I
  32. will only outline the differences for now.
  33.  
  34. Please note that there are some IMPORTANT differences, so please read through
  35. this file for complete information on those differences.
  36.  
  37. Command line switches
  38. ---------------------
  39. -M<txtfile>
  40.  
  41. This works exactly like SUBDATE's -M switch with the exception being that
  42. its usage is OPTIONAL in TIMECHEK.  This is because there may be times
  43. when you want to DELETE users with expired subscriptions.  No sense in
  44. sending a message in that case.
  45.  
  46. -Nn
  47.  
  48. Post the message (if the -M switch is used) to Board n.  This has changed
  49. from SUBDATE which uses the -B switch.  The reason for this is that TIMECHEK
  50. allows flag changes and this would have conflicted with the -B flag switch.
  51.  
  52. -P
  53.  
  54. This switch has changed meaning in SUBDATE v0.3 and TIMECHEK.  Since it is
  55. very unlikely the subscription notifications will be delivered in public
  56. messages, the default is now PRIVATE.  If you DO NOT want the message to
  57. be PRIVATE, use this switch.
  58.  
  59.  
  60. -Sn
  61.  
  62. If the user's subdate has expired, set his/her security level to n.  This
  63. is an optional switch.
  64.  
  65. -D
  66.  
  67. No parameters follow this switch.  If the user's subdate has expired, mark
  68. 'em deleted.  This does NOT purge the user from the file.  In SUBDATE this
  69. switch is used for the number of days.
  70.  
  71.  
  72. -F"name"
  73.  
  74. Used to change the hardcoded FROM: name in the message to whatever you like.
  75. Same as SUBDATE.
  76.  
  77.  
  78. -J"subject"
  79.  
  80. Used to change the hardcoded SUBJECT to one of your chosing.  Same as SUBDATE.
  81.  
  82.  
  83. -L<filename>
  84.  
  85. Log the output to filename.  The same as SUBDATE with the exception being
  86. the default filename is TIMECHEK.LOG.
  87.  
  88.  
  89. /<flag><settings>
  90.  
  91. This is used to define the changes you want to make to any or all of the four
  92. user flags.
  93.  
  94. First, the "/" used to delimit the flag switch is optional.  You may use
  95. the hyphen character as with the other switches.
  96.  
  97. Use of the flag changing capabilities of TIMECHEK is totally optional. You
  98. may use one or all flags here, or any combination of flags.
  99.  
  100. You MUST define all eight positions of each flag you use.  Not to worry,
  101. it is NOT necessary to change the entire flag, but there must be some way
  102. for TIMECHEK to know which flag positions you DO NOT want changed.  Ok, a
  103. simple demonstration is in order...
  104.  
  105. TIMECHEK -S10 /A--****** /B*******X
  106.  
  107. TIMECHEK will sweep through your user file.  If a user's subscription date
  108. has expired, his/her security level will be changed to 10 and A1 and A2
  109. will be turned OFF, B8 will be turned ON.  All other A and B flag positions
  110. (those containing an asterisk) will remain whatever they were before TIMECHEK
  111. ran.
  112.  
  113. A hyphen will turn that flag position OFF.  An X (or an x) will turn it on.
  114. =ANY= other character will make TIMECHEK leave that flag position alone. I
  115. used the asterisk character but you can use anything you can type on your
  116. keyboard.
  117.  
  118. The following would work exactly like the above example...
  119.  
  120. TIMECHEK -S10 /A--$$$### /B%$#@!#+X
  121.  
  122. A bit of an extreme example and confusing,  but this will show you that
  123. only the hyphen and X are of significance.  Also remember, the number of
  124. characters following the /A, /B, /C or /D must be exactly 8. If there are
  125. fewer than 8 or more than 8, that flag will be ignored completely.
  126.  
  127. Last but not least, when TIMECHEK finds a user whose subscription has
  128. expired, that user's subdate field is blanked out. This will keep the user
  129. from being acted upon each time TIMECHEK is run.
  130.  
  131.  
  132.                                 <EOF>
  133.